home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir42 / er304.zip / README.DOC < prev    next >
Text File  |  1994-03-10  |  21KB  |  515 lines
  1.  
  2.  
  3.  
  4.                                 EDITRAND 3.04
  5.  
  6.                              By CMD Data Services
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                ┌────────────────────────────────────────────────┐
  13.                │             ┌───────┐                          │█
  14.                │        ┌────┴──┐    │                (R)       │█
  15.                │      ──│       │O   │───────────────────       │█
  16.                │        │  ┌────┴╨─┐ │  Association of          │█
  17.                │        │  │       │─┘  Shareware               │█
  18.                │        └──│   O   │    Professionals           │█
  19.                │      ─────│   ║   │─────────────────────       │█
  20.                │           └───╨───┘    MEMBER                  │█
  21.                └────────────────────────────────────────────────┘█
  22.                 ██████████████████████████████████████████████████
  23.  
  24.  
  25.  
  26.  
  27.  
  28.     Welcome to EditRand Version 3.04.  I hope you find this program to be
  29.     quite useful.  EditRand will run on any IBM PC/XT/AT/PS2 or 100%
  30.     compatible, and requires MSDOS version 3.0 or greater and 400K
  31.     available RAM.  EditRand will run on either a hard disk or floppy disk
  32.     system, and automatically detects the default monitor type (color or
  33.     monochrome), and uses an appropriate color scheme.
  34.  
  35.     A full list of the files supplied with EditRand, and a brief
  36.     description, can be found in the accompanying file PACKING.LST.
  37.  
  38.  
  39.     Important files for users:
  40.  
  41.        SHR-WARE.DOC
  42.        LICENSE.DOC
  43.        WARRANTY.DOC
  44.  
  45.  
  46.     Important files for distributors, vendors, and BBSs:
  47.  
  48.        FILE_ID.DIZ
  49.        DESCRIBE.DOC
  50.        SYSOP.DOC
  51.        VENDOR.DOC
  52.  
  53.  
  54.  
  55.  
  56.                               PLEASE REGISTER
  57.  
  58.     EditRand is a shareware program.  The version you have is for
  59.     evaluation purposes only, but is a fully functioning version.
  60.  
  61.     Support the shareware concept.  If you use this program beyond the 30 day
  62.     evaluation period, you are required to register.  For your registration
  63.     fee you will receive:
  64.  
  65.       (1) A printed, bound up-to-date copy of the documentation,
  66.  
  67.       (2) the latest version without the UNREGISTERED VERSION reminder,
  68.  
  69.       (3) the next release free,
  70.  
  71.       (4) unlimited support,
  72.  
  73.       (5) a copy of the NUMRECS utility.  NUMRECS will tell you the number
  74.           of records of any size that will fit on the total and available
  75.           disk space of any (or all) drives.
  76.  
  77.     Read the file SHR-WARE.DOC for information on the shareware
  78.     concept and industry.
  79.  
  80.     To register, read the file LICENSE.DOC.  If you agree with the
  81.     terms, print a copy of the accompanying file REGISTER.FRM,
  82.     fill it out and mail the form with payment to the indicated address.
  83.  
  84.  
  85.                  THANKS FOR SUPPORTING THE SHAREWARE CONCEPT.
  86.  
  87.  
  88.                                  VIRUSES
  89.  
  90.     Anyone concerned about the validity of any of these files may call or
  91.     write to me for a list of the correct CRCs (Cyclic Redundancy Check)
  92.     for these files.  You must have a program that will tell you what the
  93.     CRCs are for the files you possess, then compare against the CRC
  94.     numbers I give you.  This will help protect against viruses or
  95.     accidental corruption.  If you received your shareware evaluation copy
  96.     of EditRand from an ASP approved vendor or BBS, the chances of virus
  97.     infection are very small.  The very best way to assure that you receive
  98.     valid files is to REGISTER your copy with CMD Data Services.  See the
  99.     file SHR-WARE.DOC for more information about viruses.
  100.  
  101.  
  102.                           EDITRAND DOCUMENTATION
  103.  
  104.     To print the EditRand documentation, use the DOS PRINT command, or issue
  105.     the DOS command "COPY ERDOC.PRN PRN".  The file ERDOC.PRN is formatted for
  106.     60 lines per page.
  107.  
  108.  
  109.                               SAMPLE DATA FILES
  110.  
  111.     The supplied sample data files are called 1099.DAT and 1099.DBF.  As
  112.     the name indicates, they contain 1099 records as reported by banks
  113.     and other institutions.
  114.  
  115.     Also on the distribution disk is an initialization file ER.INI that
  116.     contains the working environment created for 1099.DAT.  Please look at
  117.     Appendix C in the manual for a tutorial that will demonstrate some
  118.     important EditRand operations using 1099.DAT and 1099.DBF for
  119.     experimental purposes.
  120.  
  121.  
  122.  
  123.                                    SUPPORT
  124.  
  125.     Registered EditRand customers receive unlimited support.  That is,
  126.     there is no time limit.  Before calling for support, please read the
  127.     manual thoroughly and follow through the supplied tutorial in Appendix
  128.     C of the manual.
  129.  
  130.     For technical assistance with EditRand, the preferred channel is on
  131.     Compuserve, ID 70701,2123.  Email is checked several times a week, and
  132.     more thought can be given to questions and concerns before responding
  133.     in this way.
  134.  
  135.     For licensing or customization questions, or technical support
  136.     questions from registered customers, please call or write to
  137.  
  138.        Scott Whitehead
  139.        CMD Data Services
  140.        10413 Firethorn Lane
  141.        Austin, TX 78750
  142.        (512) 335-0579
  143.  
  144.     For a bug report or enhancement request, it is preferable to fill out
  145.     and send the supplied Report Form (see the file REPORT.FRM).
  146.  
  147.  
  148.                                   ASP HUB BBSs
  149.  
  150. In an effort to make it easier for you to obtain your favorite software, the
  151. latest updates of many ASP authored programs, including EditRand, can be found
  152. on the BBSs listed below.  These BBSs are members of the ASP Hub Network (AHN).
  153.  
  154. Zone 1 - East Coast USA
  155.  
  156.      North-East Coast                      Mid-East Coast
  157.  
  158. [Site #1]                             [Site #2]
  159.      The Consultant BBS                    The Break RBBS <East>
  160.      Jay Caplan                            Bruce Jackson
  161.      P.O. Box 8571                         4660 Whitaker PL
  162.      New York NY 10116-4655                Dale City, VA 22193-3011
  163.      Data1) 718-837-3236                   Data1) 703-680-9269
  164.      Data2)                                Data2) 703-551-0000
  165.  
  166. Zone 2 - North Mid-USA               Zone 3 - Southern Mid-USA
  167.  
  168. [Site #3]                             [Site #4]
  169.      The Twilight Zone                     The DataExchange BBS
  170.      John Hrusovszky                       Don Morris
  171.      1119 E. Main St                       119 Herring St.
  172.      Auburndale, WI 54412                  Leesville, LA 71446
  173.      Data1) 715-652-2758                   Data1) 318-239-2122
  174.      Data2)                                Data2)
  175.  
  176. Zone 4 - West Coast USA
  177.  
  178. [Site #5]                            [Site #6]
  179.      Attention to Details BBS             Space BBS
  180.      Clint Bradford                       Owen Hawkins
  181.      5085 Trail Canyon Dr                 PO Box X
  182.      Mira Loma CA 91752                   Menlo Park, CA 94026
  183.      Data1) 909-681-6221                  Data1) 415-323-4398 (ASP Files)
  184.      Data2)                               Data2) 415-323-4193 (Other Files)
  185.  
  186. Zone 5 - Canada
  187.  
  188. [Site #7]
  189.      Knightec BBS
  190.      Phil Knight
  191.      35 Robb Blvd #6
  192.      Orangeville, ONT L9W 3L1
  193.      Data1) 519-940-0007
  194.      Data2)
  195.  
  196.  
  197. These BBSs are bound by special agreement with the ASP.  In the case of a
  198. dispute contact the ASP Omsbudsman.
  199.  
  200.  
  201.  
  202.                           EDITRAND 3.04 DESCRIPTION
  203.  
  204.  
  205.     EDITRAND can be used to analyze data files in ways not possible using
  206.     the program that created the data.  Using EDITRAND, data can be viewed
  207.     exactly as it exists on disk, allowing speedy verification of program
  208.     output and intelligent troubleshooting of problem situations.  Avoid
  209.     long hours of testing - use EDITRAND to peek at those data files and
  210.     find the exact fields and records that are suspected of being corrupt
  211.     or invalid.  Have you found that an application will not allow a change
  212.     that is desired?  Load the data file into EDITRAND, swiftly make the
  213.     desired changes, and put the data back into operation without a lengthy
  214.     waiting period.
  215.  
  216.     Highlights:
  217.  
  218.        *      Browse and  edit  random  files  produced  by  any
  219.               program, regardless of record structure.  A RANDOM
  220.               file is any file whose records are all the same length.
  221.  
  222.        *      Flat data  files, data  files with any proprietary
  223.               header, or dBASE III format files.
  224.  
  225.        *      Display an  entire record  on the  screen  at  one
  226.               time.
  227.  
  228.        *      Determine exact  location of  data fields with the
  229.               use of ruled display and user definable tab stops.
  230.  
  231.        *      Full text,  hexidecimal, binary  numeric and ASCII
  232.               data editing.
  233.  
  234.        *      Cursor key  navigation  just  like  ordinary  text
  235.               editors.
  236.  
  237.        *      Perform standard editing functions such as Search,
  238.               Replace, Word Count, Cut and Paste.
  239.  
  240.        *      Make global changes to specific fields, such as case
  241.               conversion, character fill, or paste from scratchpad.
  242.  
  243.        *      Perform record  functions such  as Append, Delete,
  244.               Copy, Move and Sort.
  245.  
  246.        *      Full featured  binary number  operations (IEEE  or
  247.               Microsoft Binary Format).
  248.  
  249.        *      Restrict operations  to a  range of records and/or
  250.               range of  columns (this  allows the  user to focus
  251.               operations on a particular data field)
  252.  
  253.        *      Globally convert entire records or specific fields to
  254.               upper or lower case, or fill with any character.
  255.  
  256.        *      Undelete/Undo changes to records
  257.  
  258.  
  259.        *      Create backup files for security purposes
  260.  
  261.        *      On line  help screen  showing all defined function keys
  262.  
  263.        *      Works on files up to 2 billion bytes in size, record size
  264.               up to 3600 bytes per record.
  265.  
  266.        *      Maximum record length is:
  267.  
  268.               -  1600 bytes  per record in standard 80 X 25 text mode,
  269.  
  270.               -  3040 bytes  per record  in 80  X 43  mode  (EGA required),
  271.  
  272.               -  3600 bytes  per record  in 80  X 50  mode  (VGA required).
  273.  
  274.  
  275.                               PROGRAM CHANGES
  276.  
  277.  
  278.     Version 3.0:
  279.  
  280.        *    Maximum record length increased from 1600 to 3040 bytes
  281.             (EGA monitor required), or 3600 bytes (VGA required.)
  282.  
  283.        *    Specify a header offset from the beginning of the file
  284.             from which to begin viewing of records (tested and
  285.             debugged since version 2.0).
  286.  
  287.        *    Improved file selection window.
  288.  
  289.        *    Addition of Currency numeric data type.
  290.  
  291.        *    Improved color scheme.  Allows forcing of monochrome
  292.             attributes.
  293.  
  294.        *    Enhanced Replace options.  Globally convert to upper and
  295.             lower case; globally delete records that contain
  296.             specified string; globally fill any field with a string
  297.             of any character.
  298.  
  299.        *    Enhanced Append.  Append any number of records with
  300.             single Append operation.  Optionally fill each appended
  301.             record with content of scratchpad.
  302.  
  303.        *    Enhanced dBASE III mode.
  304.  
  305.        *    Improved Range Delete and Undelete/Undo.
  306.  
  307.        *    Improved method of handling and purging of deleted
  308.             records.
  309.  
  310.        *    Option to force EDITRAND to maintain one centrally
  311.             located copy of the initialization file (ER.INI), instead
  312.             of, by default, creating it in the subdirectory from
  313.             which EDITRAND is executed.
  314.  
  315.        *    As of version 2.1, the name of the EDITRAND defaults file has
  316.             been changed from ER.DEF to ER.INI.  There is no method of
  317.             converting ER.DEF files to ER.INI format, so you will have to
  318.             go on a search and destroy mission for those instances of
  319.             ER.DEF on your disk(s).
  320.  
  321.        *    EDITRAND has always made backup files with the extension
  322.             .BAK.  Beginning with Version 2.1, backup files now have
  323.             the extension .ERB.  This was done to help users spot
  324.             EDITRAND backup files more easily, since many other
  325.             software programs use .BAK as their backup extension.
  326.  
  327.        *    No manual changes have been made since version 2.1.  The jump
  328.             in version numbers was made primarily to indicate the exhaustive
  329.             testing, debugging, and refinement that has taken place.
  330.  
  331.        Version 3.01:
  332.  
  333.        *    The only additional functionality is the ability to increase a
  334.             data file record length by inserting a new field anywhere in
  335.             the record structure.  This is done through the Save As
  336.             function (Alt-V).  Previously Save As allowed saving only
  337.             portions of a record, which in effect meant you could
  338.             "collapse" a record structure.  Now you can do the opposite.
  339.             The prompt for adding a new field appears only if no field
  340.             bound is set:
  341.  
  342.               Do Simple Copy, or insert New field at cursor position ?
  343.  
  344.             If New Field is chosen, you will be prompted for size of new field
  345.             and whether you want it inserted before or after the current
  346.             cursor position.  If the scratchpad is not empty, you will be
  347.             asked if you want to paste the scratchpad into the new field.
  348.  
  349.             It is possible to create a Save As output file that is too large
  350.             for EditRand to handle (greater than 3600 bytes per record).
  351.  
  352.        Version 3.02:
  353.  
  354.        *    If Dynamic fields are turned on, the current field is
  355.             highlighted.  This allows easy determination of the record
  356.             area that is the current "focus".
  357.  
  358.        *    Dynamic fields are now turned on by default.  Ctrl-F toggles
  359.             dynamic fields.
  360.  
  361.        *    When in edit mode, the PageUp and PageDown keys can used to
  362.             adjust the foregound and background colors.  If the cursor is
  363.             on a highlighted field, only the highlight foreground and
  364.             background are changed.  If the cursor is out of the current
  365.             field bounds area, only non-bounds area colors are changed.
  366.             These colors are saved in ER.INI.
  367.  
  368.        *    Most typed responses are recallable and editable now (long
  369.             overdue).  For example, when in edit mode and you issue a
  370.             Replace command (Alt-R), the next time you type Alt-R, the
  371.             previous Replace string will be presented for editing.  To use
  372.             the previous string, use the left cursor or backspace key
  373.             first; typing a character first erases the previous string and
  374.             starts over.
  375.  
  376.        *    When specifying a Replace string in Hex or Bin mode, it is now
  377.             possible to specify a non-Hex or non-Binary target or
  378.             replacement.  In other words if you have pressed Alt-R then
  379.             either F1 or F2, the target or replacement must still be hex
  380.             or binary, but one or the other can be a normal character
  381.             string. For example, in hex mode:
  382.  
  383.                /0C 0A/\!!/
  384.  
  385.             This will cause the next occurrence of carriage return/line
  386.             feed to be replaced with a pair of exclamation points.  The
  387.             backslash is used as a special character that tells EditRand
  388.             to treat what follows as literal characters (that is, don't try
  389.             to interpret them as hex characters.)  The reverse would be
  390.  
  391.                /\!!/0C 0A/
  392.  
  393.  
  394.        *    "Byte Locate" (Alt-B) now allows either decimal or hexidecimal
  395.             representation.  Decimal is still the default.  If you wish to
  396.             express a hex value, precede it with a "H".  For example, to
  397.             locate byte 3E8 (decimal 1000), enter "H3E8".
  398.  
  399.        *    The file and record offset numbers on the right side of line 2
  400.             can be toggled between decimal and hexidecimal with Alt-F1.
  401.             This setting is recorded in ER.INI.
  402.  
  403.        *    The Offset number, which appears only in Edit Mode, always
  404.             meant the offset of the cursor position from the beginning of
  405.             the current record.  This number can now be toggled to
  406.             represent the offset from the beginning of the current field
  407.             (if field bounds are set) with Alt-O.  This setting is
  408.             recorded in ER.INI.
  409.  
  410.        *    Until version 3.02, if you tried to load a Read Only file, you
  411.             would be forced into Browse Mode.  You can now place the
  412.             cursor into the record display area of a Read Only file, but
  413.             no alterations are allowed.
  414.  
  415.        *    New with Version 3.02, you can tell by looking at the file
  416.             name on line 1 of the display if you have made any changes to
  417.             the file.  After the cursor leaves the record in which the
  418.             first alteration is made, a special character (ASCII 241: ±)
  419.             appears to the left of the file name.
  420.  
  421.        *    Prior to version 3.02, if you edited a file, then pressed "Q"
  422.             to exit, changes were kept automatically and EditRand exited
  423.             to DOS.  Now in such a case, the user is prompted:
  424.  
  425.                Save changes (Y/N/Esc) [Yes] ?
  426.  
  427.             Yes is the default answer if carriage return is pressed.
  428.  
  429.        *    A general manual revision was published for 3.02.
  430.  
  431.  
  432.        Version 3.03 Changes
  433.  
  434.        Version 3.03 is a bug release only, no functional changes,
  435.        therefore the manual is identical.  The following bugs have
  436.        been fixed:
  437.  
  438.        - Setting a tab stop with F9 worked fine, but un-setting the
  439.          same tab stop resulted in the wrong rule numbers being
  440.          displayed on that line.
  441.  
  442.        - The program allowed greater than the maximum record length
  443.          of 3600 bytes/record, which could do strange things if you tried.
  444.  
  445.        - Under certain circumstances, word count would display the
  446.          Replace prompt (it didn't really mean it though).
  447.  
  448.  
  449.        Version 3.04 Changes
  450.  
  451.        Version 3.04 is a bug release only, no functional changes,
  452.        therefore the manual is identical.  The following bugs have
  453.        been fixed:
  454.  
  455.        - ER would hang under DR DOS 6.x.  This has been fixed.
  456.  
  457.        - File selection window (F8) did not function properly on a
  458.          CD ROM drive.  This has been fixed.
  459.  
  460.        - ER did not work properly on Netware 3.11 drives.  This has been
  461.          remedied.  You may specify Netware drives now, but ER will
  462.          convert such file names to full UNC (Universal Naming Convention)
  463.          names, like \\SERVER\ADMIN\MYDATA.TXT.
  464.  
  465.          Please note that the only Netware drives ER has been tested against
  466.          is Netware 3.11.
  467.  
  468.  
  469.                           Known Bugs or Anomalies
  470.  
  471.        Loading files on a Netware drive, I am occasionally getting
  472.        error 12 (General Failure) during creation of backup files.
  473.        File size seems to have nothing to do with it.  I have not determined
  474.        the pattern and it has only happened 3 times.   Please report
  475.        this to me if it has happened to you.
  476.  
  477.  
  478.  
  479.  
  480.                             EDITRAND Customization
  481.  
  482.  
  483.        If you  have special editing requirements that EDITRAND does
  484.        not address,  CMD Data  Services also provides customization
  485.        of the  EDITRAND program.  For example, EDITRAND could be tailored
  486.        to:
  487.  
  488.                1.     Intelligently load and handle  specified
  489.                       proprietary data file formats.
  490.  
  491.                2.     Handle alternate character sets.
  492.  
  493.                3.     Generate indexes or format/prefill records
  494.                       and fields to specification.
  495.  
  496.                4.     Generate custom reports.
  497.  
  498.                5.     Calculation functions.
  499.  
  500.  
  501.        If interested,  please submit  a letter  of intention,  outlining
  502.        your requirements to:
  503.  
  504.             Scott Whitehead
  505.             CMD Data Services
  506.             10413 Firethorn Lane
  507.             Austin, TX 78750-1740
  508.  
  509.  
  510.        Please include  a  summary  technical  description  of  your
  511.        requirements.   An immediate response will be sent to verify
  512.        that  your   request  has  been  received,  and  a  detailed
  513.        response, including cost estimates, will be forthcoming 1 to
  514.        3 weeks later.
  515.